Download
FAQ
History
HomeHomeNext API
Search
Feedback
Divider

The Example JSP Pages

This chapter describes the tasks involved in defining tags. The chapter illustrates the tasks with excerpts from the JSP version of the Duke's Bookstore application discussed in The Example JSP Pages rewritten to take advantage of several new custom tags:

The last section in the chapter, Examples, describes several tags in detail: a simplified iteration tag and the set of tags in the tutorial-template tag library.

The tutorial-template tag library defines a set of tags for creating an application template. The template is a JSP page with placeholders for the parts that need to change with each screen. Each of these placeholders is referred to as a parameter of the template. For example, a simple template could include a title parameter for the top of the generated screen and a body parameter to refer to a JSP page for the custom content of the screen. The template is created with a set of nested tags--definition, screen, and parameter--that are used to build a table of screen definitions for Duke's Bookstore and with an insert tag to insert parameters from the table into the screen.

Figure 14-1 shows the flow of a request through the following Duke's Bookstore Web components:

Request Flow Through Duke's Bookstore Components

Figure 14-1 Request Flow Through Duke's Bookstore Components

The source code for the Duke's Bookstore application is located in the <INSTALL>/j2eetutorial14/examples/web/bookstore3/ directory created when you unzip the tutorial bundle (see About the Examples). A sample bookstore3.war is provided in <INSTALL>/j2eetutorial14/examples/web/provided-wars/. To build, package, deploy, and run the example:

  1. Build and package the bookstore common files as described in Duke's Bookstore Examples.
  2. In a terminal window, go to <INSTALL>/j2eetutorial14/examples/bookstore3/.
  3. Run asant build. This target will spawn any necessary compilations and copy files to <INSTALL>/j2eetutorial14/examples/web/bookstore3/build/.
  4. Start the J2EE application server.
  5. Perform all the operations described in Accessing Databases from Web Applications.
  6. Start deploytool.
  7. Create a Web application called bookstore3.
    1. Select FileRight ArrowNewRight ArrowWeb Application WAR.
    2. Select the Create New Stand-Alone WAR Module radio button.
    3. Click Browse.
    4. In the file chooser, navigate to <INSTALL>/j2eetutorial14/examples/web/bookstore3/.
    5. In the File Name field, enter bookstore3.
    6. Click Choose Module File.
    7. In the WAR Display Name field, enter bookstore3.
  8. Add Web application files and libraries.
    1. Click Edit.
    2. Add the application content. In the Edit Contents dialog, navigate to <INSTALL>/j2eetutorial14/examples/web/bookstore3/build/. Select the JSP pages bookstore.jsp, bookdetails.jsp, bookcatalog.jsp, bookshowcart.jsp, bookcashier.jsp, bookreceipt.jsp, bookordererror.jsp, Dispatcher.class and the database, listeners, and template directories and click Add. Click OK.
    3. Add the shared bookstore library. Navigate to <INSTALL>/j2eetutorial14/examples/build/web/bookstore/dist/. Select bookstore.jar and Click Add.
  9. Define the Web component.
    1. Click Next.
    2. Select the Servlet radio button.
    3. Click Next.
    4. Select Dispatcher from the Servlet class combo box.
    5. Click Finish.
  10. In the Deployment Setting frame, set the Context Root field value to /bookstore3.
  11. Add the aliases.
    1. Select Dispatcher.
    2. Select the Aliases tab.
    3. Click Add and then type /bookstore in the Aliases field. Repeat to add the aliases /bookcatalog, /bookdetails, /bookshowcart, /bookcashier, /bookordererror, and /bookreceipt.
  12. Add the JSTL resource bundle basename context parameter.
    1. Select the Context tab.
    2. Click Add.
    3. Enter javax.servlet.jsp.jstl.fmt.localizationContext for the Coded Parameter.
    4. Enter messages.BookstoreMessages for the Value.
  13. Set prelude for all JSP pages.
    1. Select the JSP Properties tab.
    2. Click the Add button next to the Name list.
    3. Enter bookstore3.
    4. Click the Add button next to the URL Pattern list.
    5. Enter /*.jsp.
    6. Click the Edit button next to the Include Preludes list.
    7. Click Add.
    8. Enter /template/prelude.jspf.
    9. Click OK.
  14. Add a resource reference for the database.
    1. Select the Resource Refs tab.
    2. Click Add.
    3. Enter jdbc/BookDB in the Coded Name field.
    4. Accept the default type javax.sql.DataSource.
    5. Accept the default authorization Container.
    6. Accept the default selected Shareable.
    7. Enter jdbc/BookDB in the JNDI name field of the Deployment setting for jdbc/BookDB frame.
  15. Deploy the application.
    1. Select ToolsRight ArrowDeploy.
    2. Click OK.
    3. A popup dialog will display the results of the deployment. Click Close.
  16. Open the bookstore URL
    http://localhost:1024/bookstore3/bookstore.

See Troubleshooting for help with diagnosing common problems.

Divider
Download
FAQ
History
HomeHomeNext API
Search
Feedback
Divider

All of the material in The J2EE 1.4 Tutorial is copyright-protected and may not be published in other works without express written permission from Sun Microsystems.